home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / graphics / gnuplot / contrib / byrne / README < prev   
Text File  |  1992-03-25  |  5KB  |  91 lines
  1. This shar archive contains the following files
  2.      readme           this file
  3.      congp2d3.for     a preprocessor to draw contour plots on irregular
  4.                       regions with gnuplot
  5.      congp2d3.dem     a demo illustrating the results of congp2d3.for
  6.      ex3o.bot         sample input file 1/2 for congp2d3.for
  7.      pdoge30.u3       sample input file 2/2 for congp2d3.for
  8.      poeu3o.g3        sample edited output file 1/3 from congp2d3.for
  9.      poeu3o.l3        sample edited output file 2/3 from congp2d3.for
  10.      ex3o.bdy         sample edited output file 3/3 from congp2d3.for
  11.           (note:  congp3d3.dem uses poeu3o.g3, poeu3o.l3, and ex3o.bdy,
  12.            so use other file names when you run congp2d3.for so that
  13.            you can see how they need to be touched up.)
  14.  
  15. I have tested congp2d3.for only under MS-DOS with the compiler 
  16. WATFOR77 or WATFOR87, but the only extension message which
  17. the compiler produces is from the non-capital letters.  Everything
  18. else should be ANSII standard.  The open statements, which vary
  19. from OS to OS, may need to be changed.
  20.  
  21. The preprocessor congp2d3.for is a fortran program which takes 
  22. 3-d data for an irregular region and finds the location of the
  23. contour lines.  Contour plots are used in several areas of
  24. engineering to display values of a dependent variable versus
  25. two independent ones.  Sometimes the region on which
  26. the dependent variable is defined is irregular.  For instance,
  27. the concentration of a pollutant in a lake only makes sense 
  28. within the lake, although the concentration of the pollutant 
  29. in the groundwater in the region near the lake may be another
  30. research project.  Lakes, hills, and so forth often come in
  31. funny shapes.
  32.  
  33. I wrote congp2d3.for because a certain commercial package which
  34. I had planned to use to put contour plots into my dissertation 
  35. dreamt up something that looked like Pike's Peak next to Death
  36. Valley and stuck it in the middle of my plots.  I wrote it in
  37. fortran because I don't know C.  Congp2d3.for reads the 3-d
  38. data in the format which was required for the ill-fated commercial
  39. package.  It can easily be modified to read the data in the
  40. format that gnuplot uses for 3-d data files.
  41.  
  42. As the demo says, the output from congp2d3.for may need to be
  43. touched up in the following ways:
  44.      1. Sometimes the contour labels are less than artistically placed.  
  45.         After viewing the plot with the lables where congp2d3.for
  46.         put them, the user can adjust them using a multiwindow 
  47.         editor to find more suitable locations for them along 
  48.         their respective contour lines.  The label generated by
  49.         congp2d3 will be along the contour in question.  Usually,
  50.         the user will want to edit the labels anyway to reduce the
  51.         number of significant digits and remove leading blank spaces.
  52.      2. If there is an indentation, the user may need to add a couple
  53.         of points to the file with the boundary coordinates.
  54.      3. This point is not mentioned in the demo.  In the rare case 
  55.         where an element has four points on a given contour, congp2d3.for
  56.         will prepare instructions to plot all 6 possible lines through 
  57.         that element.  The user should insert blank lines into the
  58.         file to separate points which should not be connected after all.
  59.  
  60. The program congp2d3.for uses parameter statements in the main program.
  61. These parameter statements specify the exact correct length for all of
  62. the arrays.  The user needs to edit them to match the data in question.
  63.  
  64. The program congp2d3.for is heavily commented, to make it easier for 
  65. anyone who wishes to modify it.  It is public domain, unrestricted use
  66. software.  Gnuplot itself is copyrighted but may be copied freely.  
  67. See the gnuplot documentation for details of the licensing conditions
  68. for gnuplot.
  69.  
  70. I think that congp2d3.for could be improved by using an array of which
  71. nodes are in each element to do the search for contour lines.  Using
  72. such an array would make it possible to contour data on completely
  73. arbitrarily shaped regions with arbitrary node and element numbering 
  74. schemes, I think.  I also think that such a change would make it 
  75. possible to recover the coordinates of all points on the boundary by
  76. counting the number of elements that each node is in.  Perhaps the 
  77. contour labeling scheme could be improved, too.
  78.  
  79. I am making congp2d3.for available without any warrantee.  The email
  80. address in the shar file will stop working as soon as I finish
  81. my dissertation.  I am starting work on April 6, 1992 but may be
  82. accessing my accounts at UVa from time to time after that date.  My
  83. business address is as follows:
  84.      US Nuclear Regulatory Commission
  85.      Mail Stop WF6E6
  86.      Washington, DC 20555.
  87. I will be doing a lot of travelling for this job, so letters may
  88. take a long time to get to me. 
  89.  
  90. Rose Byrne
  91.